         -+-  Procedure Explorer  v1.61   *   Copyright (C) JP 2o14   -+-
         ==============================================================


Description
===========
Procedure Explorer is free windows application  that show you  what programs are
called from your PROGRESS source (.p, .w, .i, .r ...) or it can display includes
*.i  from your  rcode  (if it's debug segment presented).  It support also  some
defined MFG runtime includes.  Application can find sources  where is referenced
your targed program or can search files up to top of the call stack.


How to use it
=============
You can  browse  directory  where you have  located sources  and explore runtime
calls.  Dependencies are searched in ProPath so you must set it at the beginning
otherwise will be searched  only in current  dir.  Files that are in propath but
not in current dir are marked as Bold. Priority has ProPath and then current dir.
To ProPath can be added dirs  manually  with browsing  or  writing path to input
field and clicking to ADD button. Other way is import it from your Progress.ini.
Your Path configuration is possible save and load. Only existing path can be add
to environment!

Where is program referenced -  program search in propath where is referenced our
  program.p (searching also automatically for program.r).  Application try parse
  out all comments so only live strings are searched.
  It doesn't parse RUN statements like in exploring, it's just strings occurrence
  in file!

Top of the program call stack - is working like "Where is program referenced" but
  after some program is find, application it's searching for occurrence this new
  file name and so on until top of the stack is reached. You can set max level to
  bypass circular calling.  Beware, on lot of files can take some time until the
  whole process is finished.

Process MFG runtime includes - when this option is ON, then Explorer can extract
  calling programs from various MFG runtime includes like:
  gprun.i, cxcustom.i, gprun#.i (where # is 0-9)
  gprunex.i, gprunmo.i
  gprunp.i, gprunpdf.i

For using possibility "Load to Piew" you need download Piew editor 2.4 or higher
http://progress-tools.x10.mx/piew.zip  and set path to  piew.exe in Settings.
You can also use other editor. After load you have already in clipboard selected
file name, useful if you immediately search for call location.


Icon colors:
============
Blue        - Main *.p sources in current dir
Yellow      - Main *.w sources in current dir
Gray        - Main *.i sources in current dir
White       - Main *.r sources in current dir
Green       - Dependencies that exist in ProPath
Red         - Not existing dependencies

Background colors:
==================
Orange      - MFG runtime Includes
Light green - Last file in top of the call stack
Pale green  - Last file in top of the call stack (already used before somewhere 
              at the top)
Light red   - Reached maximal level in top of the program call stack

Style:
======
Bold        - Files that are in propath but not in current dir

Shortcut keys:
   F2  - Save tree to log file
   F3  - Search next occurence in tree
   F4  - Load to Piew
   F5  - Refresh directory
   F6  - Copy to CopyPath
   F7  - New search in tree
   Ctrl + F - Where is program referenced
   Ctrl + T - Top of the program call stack
   Ctrl + C - Copy to clipboard
   Ctrl + A - Copy Tree to clipboard
   Ctrl + Q - Quit
   Shift + F2 - Save your propath
   Shift + F3 - Load your propath
   Shift + F4 - Import PROGRESS ini to your propath


Known limitations, Bugs
=======================
In some cases program can  evaluate wrong  filename from your source but you can
see this problem immediately.  Also comment marks /* */ inside quoted string can
make problem.

Use this application entirely at your own risk.  The author assumes no liability
for any loss associated with  the use  of  this application. If you do not agree
with the terms, do not use this application.


System requirements
===================
For run you need VB6 runtime MSVBVM60.DLL and MSCOMCTL.OCX.  If not then you can
download it from  web. (On Windows XP you should already have it)


Contact
=======
Visit http://progress-tools.x10.mx for more information or updates.  If you have
some ideas,  comments,  improvements or you find some bug you can mail to me at
darker@azet.sk

History
=======
1.0 - [17.11.2004]
Initial version.

1.1 - [17.04.2006]
Fix: Source in current path show in red (as not found)
Fix: False alarm when link to RCode doesn't exist
Fix: Rcodes with no debug section
Add: You can define your own include types
Add: Copy, Copy All to clipboard
Add: StatusBar with file path, size and date
Add: Search, Search Next
Upd: Optimized code

1.2 - [02.02.2007]
Fix: Processing existing expression on last line
Upd: Colors of icons has changed
Fix: Includes with same prefix extension .i and .i* are processed twice
Fix: All comments are now excluded properly

1.3 - [06.03.2007]
Add: Window resize
Add: Load to Piew (or other editor)
Add: Copy files to defined path
Add: Mark files with Bold that are in propath but not in current dir
Add: Status message by loading heavy directories
Fix: Faster clear on heavy directories
Fix: Processing end comments */*/ is now ok

1.4 - [08.10.2008]
Fix: Processing start comments /*/* is now ok
Add: Process MFG runtime includes - extract calls from MFG includes
Add: F5 for refreshing directory (F6 for copy now)
Add: Support for more rcode types
Add: Set selected file to clipboard  before load in Piew  (useful when you after
     loading to editor search for call location)

1.5 - [17.11.2009] - Velvet revolution
Add: New function - Where is program referenced 
Add: New function - Top of the program call stack
Add: Ignore unbalanced comment messages
Fix: Now accept as command line also rcodes
Fix: Some rcode bugs
Fix: Copy Tree to clipboard error
Fix: Common dialog routines

1.6 - [30.12.2009]
Add: Save window position on exit (settings)
Add: Save last used propaths (max 10)
Add: In "Load to Piew" function editor jump to first place in source where is 
     call string referenced (Piew v2.5 needed)
Fix: Fixed real file path name when loading to editor in some cases

1.61 - [13.08.2014]
Upd: Removing packing to avoid false positive virus detection
Upd: Changed contact and homepage information
